home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr27 / cal33.zip / README.CAL < prev   
Text File  |  1995-01-15  |  7KB  |  162 lines
  1. CAL is a nicely-enhanced version of the unix `cal' command for MSDOS.
  2. Features:
  3.  
  4.  * Hilights today's date when displaying a monthly calendar.
  5.  
  6.  * Displays an optional user-definable list of `special day'
  7.    descriptions (like appointments) to the right of the monthly
  8.    calendar display.  Cal can be set optionally to ignore appointments
  9.    older than the current day.  Next month's appointments are shown if
  10.    there is room to do so.  Multiple appointment data files may also
  11.    be specified on the commandline.
  12.    
  13.  * You can specify your own appointment and color definition files on the
  14.    commandline, or use the defaults.
  15.  
  16.  * Date descriptions can display "years since" a given year, useful for
  17.    birthdays and anniversaries.
  18.  
  19.  * Completely configurable colors -- eight separate color attributes.
  20.  
  21.  * No ANSI driver needed for colors, and the output may be redirected
  22.    anywhere, just like the unix version.
  23.  
  24.  * Commandline-compatible with unix `cal' command, but with several
  25.    enhanced switch settings.
  26.  
  27.  * Source code included; enhanced to compile using colors under OS/2.
  28.  
  29. The executable distributed in the archive was compiled using Zortech C++
  30. 3.1 (resulting in an executable half the size of Borland's), and then
  31. compressed with LZEXE.
  32.  
  33. This archived collection of files is placed into the Public Domain.
  34. Feel free to redistribute the this archive, but PLEASE make sure the
  35. archive contains all the original files, namely:
  36.  
  37.         readme.cal        - this file
  38.         cal.exe           - the MSDOS executable program
  39.         cal.doc           - documentation for cal.exe
  40.         cal.dat           - optional sample data file of appointment dates
  41.         cal.col           - optional sample file of color attributes
  42.         source\*.os2      - four files about compiling the source for OS/2
  43.         source\cal.c      - source code for cal
  44.        
  45. Note:  _I_ think the colors defined in the color definition file
  46. cal.col are ugly!  If you want to use the more attractive (in my
  47. opinion) default colors, just delete or rename cal.col.  This file
  48. is only included to show you how it works.
  49.  
  50. The source code should be compilable for any OS.  No guarantees are made
  51. in this regard, however.
  52.  
  53. Requests, bug reports, suggestions, donations, proposals for
  54. contract work, and so forth may be sent to:
  55.  
  56.         Attn: Alex Matulich
  57.         Unicorn Research Corporation
  58.         4621 N. Landmark Drive
  59.         Orlando, FL 32817-1235
  60.         USA
  61.         407-657-4974  FAX 407-657-6149
  62.  
  63. or send e-mail to matulich_a@seaa.navsea.navy.mil.
  64.  
  65.  
  66. Version history:
  67.  
  68. 1.0
  69. Port to MSDOS of original unix-to-Amiga port by Gary L. Brant.
  70.  
  71. 2.0
  72. Modified to display calendar in colors without ANSI.SYS, while retaining
  73. output redirectability.  Added current day indicator in monthly display.
  74. Made all code compatible with unix and ANSI C by putting all MSDOS-specific
  75. code into blocks activated by #define MSDOS at beginning of source file.
  76.  
  77. 2.1
  78. Added display of special date descriptions to monthly calendar.  Re-wrote
  79. some code sections to accommodate this feature.  All arrays are now
  80. dynamic to reduce the size of the executable.
  81.  
  82. 2.2
  83. Fixed an intermittent pointer-trashing bug in the date description section
  84. that caused the monthly display to display garbage at times.
  85.  
  86. 2.3
  87. Removed hardcoded color settings, and added capability to read external
  88. color file.
  89.  
  90. 2.4
  91. Added -d switch to inhibit the display of outdated date descriptions
  92. (changed to --f in version 2.7).
  93.  
  94. 2.5
  95. Fixed two bugs reported by J"urgen Koslowski.  The "last weekday of month"
  96. function in the cal.dat file now works, and the single-month display now
  97. looks fine if the year doesn't have 4 digits.  Also re-wrote the section
  98. that processes command-line arguments.
  99.  
  100. 2.6
  101. Fixed a bug reported by Paul Beam.  Date descriptions longer than 50
  102. characters now do not blank out the next line in the calendar.
  103.  
  104. 2.7
  105. Other contributors added improved commandline switches, allowing the
  106. appointment file and color file to be specified on the commandline, and
  107. also the ability to display next month's appointments on the current
  108. month if there is room to do so.  Processing of commandline arguments
  109. has been completely replaced by the GNU getopt.c library functions.  The
  110. source will now use colors if compiled under OS/2, also, and search PATH
  111. and DPATH for data files.  A potentially serious bug pertaining to path
  112. concatenation was caught.
  113.  
  114. 2.8
  115. Added --europe switch, so that the calendar display has Monday as the
  116. first day of the week, which is a more familiar format in Europe.
  117.  
  118. 2.9
  119. A contributor sent code with several fine modifications, but it was useful
  120. only for the Borland compiler.  I have re-done it for ANSI compatibility.
  121. The maximum number of appointments to be displayed now defaults to 24, and
  122. is adjustable on the commandline.  Multiple data files may be specified.
  123. Cal no longer stops reading a data file when it has filled up its maximum
  124. number of descriptions; it now reads through the whole file so that it can
  125. sort out all dates to be displayed.
  126.  
  127. 2.9a&b
  128. a: Fixed a bug in 2.8 and 2.9 that caused cal to attempt to read its color
  129. file before determining its home directory.  Also added a contributor's
  130. suggestion to detect the number of columns for MSDOS displays wider than 
  131. 80 columns, so that appointments won't be truncated if they really can fit.
  132. b: Minor changes made for greater compatibility with other compilers.
  133.  
  134. 3.0(a)
  135. (Not significantly new, just the next number in the sequence)
  136. Replaced tabs with spaces, for systems with tab stops other than every 8
  137. characters.  Added an "anniversaries and birthdays" feature whereby if a
  138. date description contains a year in brackets or braces, this number is
  139. converted to the number of years since the year indicated.  3.0a fixes
  140. a problem when the 0th anniversary was displayed as blank.
  141.  
  142. 3.1
  143. Fixed trashed memory pointer when the number of appointments exceeded the
  144. maximum specified number of lines.  Fixed ordinal suffixes for anniversary
  145. dates between 11 and 13.  Added weekly reminder feature (specify a negative
  146. day-of-week number in NW field in cal.dat).  Added daily reminder feature
  147. (specify -9 for DY field in cal.dat).  Fixed problem with January
  148. anniversaries being 1 year off if displayed with December calendar.
  149.  
  150. 3.2
  151. Fixed display problem causing garbage to appear when changing maximum
  152. displayable appointments.  Rewrote commandline argument parsing to be more
  153. efficient.  Commandline arguments can now be preceded with a single '-'
  154. and also a '/' if using MSDOS or OS/2 (the old '--' method still works
  155. for compatibility with previous versions).  Next-month birthdays and
  156. anniversaries are no longer displayed a year older than they should be.
  157.  
  158. 3.3
  159. Fixed a problem where the "next month" appointment descriptions displayed
  160. during December were those of January that same year, instead of next year.
  161. Fixed problem that sometimes caused weekly reminders to be duplicated.
  162.